Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

common/lib/cv: Test docs #189

Merged
merged 11 commits into from
Dec 12, 2024

Conversation

e10harvey
Copy link
Collaborator

@e10harvey e10harvey commented Nov 25, 2024

Purpose

Test and complete docs in common/lib/cv

Summary of changes

Update test_DocStringsExists to include all members of common/lib/cv. Add missing doc strings

Implementation notes

Ran pytest -s -k test_docstrings

Submission checklist

  • Target branch is develop, not main
  • Existing tests are updated or new tests were added
  • opencsp/test/test_DocStringsExist.py are verified to include this change or have been updated accordingly
  • .rst file(s) under doc/ are verified to include this change or have been updated accordingly

Additional information

Please provide any additional information here.

@e10harvey e10harvey mentioned this pull request Nov 25, 2024
4 tasks
bbean23
bbean23 previously approved these changes Dec 11, 2024
Copy link
Collaborator

@bbean23 bbean23 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Conditionally approved, assuming that all my comments are addressed.

doc/source/_static/full_width_theme.css Show resolved Hide resolved
doc/source/library_reference/common/lib/cv/config.rst Outdated Show resolved Hide resolved
opencsp/common/lib/cv/OpticalFlow.py Show resolved Hide resolved
opencsp/common/lib/cv/OpticalFlow.py Outdated Show resolved Hide resolved
"""
# "ChatGPT 4o-mini" assisted with generating this docstring.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"assisted"

@@ -5,15 +5,53 @@
import opencsp as opencsp
import example as example

# TODO: why aren't these imported from import opencsp as opencsp above
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We generally don't want to import the world when importing opencsp, so we don't auto-import everything in the base /init.py file. Instead, we depend on the developer to import everything they need.

We should replace the 'from opencsp... import ...' in lines 9-14 with 'import opencsp...', to match the rest of this file's imports.

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

OK, please file an issue so we can take care of this in a follow-on PR.

@e10harvey e10harvey force-pushed the doc_strings_exist_common_cv branch from 8c44dad to d253607 Compare December 11, 2024 23:48
@e10harvey e10harvey merged commit 26c80e4 into sandialabs:develop Dec 12, 2024
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants